Skip to main content
DELETE
/
v1
/
knowledge
/
{kb_id}
/
documents
/
{document_id}
Delete Knowledge Base Document By Id
curl --request DELETE \
  --url https://api.xpander.ai/v1/knowledge/{kb_id}/documents/{document_id} \
  --header 'x-api-key: <api-key>'
"<any>"
Permanently remove a document from a knowledge base. This deletes the document file, all extracted chunks, and vector embeddings.

​
Path Parameters

​
kb_id
string
required
Unique identifier of the knowledge base (UUID format)
​
document_id
string
required
Unique identifier of the document to delete (UUID format)

​
Response

Returns 202 Accepted on successful deletion.

​
Example Request

curl -X DELETE -H "x-api-key: YOUR_API_KEY" \
  https://api.xpander.ai/v1/knowledge/4be18afd-ccbd-4092-8686-75e9df2a1bec/documents/043210de-52df-4bfd-94bb-c809fcd8d77a

​
Example Response

HTTP/1.1 202 Accepted
Content-Type: application/json

null
The endpoint returns 202 Accepted to indicate the deletion request has been accepted and will be processed.

​
Notes

  • This action cannot be undone
  • All vector embeddings for this document will be removed from search
  • Agents using this knowledge base will no longer have access to this document’s content
  • The document file itself is permanently deleted from storage

​
See Also

  • [List Documents](/API reference/v1/knowledge/list-documents) - View all documents in a knowledge base
  • [Add Documents](/API reference/v1/knowledge/add-documents) - Add new documents
  • [Get Document](/API reference/v1/knowledge/get-document) - Get document details before deletion

Authorizations

​
x-api-key
string
header
required

API Key for authentication

Path Parameters

​
kb_id
string
required
​
document_id
string
required

Response

Successful Response

The response is of type any.